home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / libdl / dlerror.z / dlerror
Encoding:
Text File  |  2002-10-03  |  1.9 KB  |  43 lines
  1. dlerror(3c)                                            Last changed: 1-8-99
  2.  
  3.  
  4. NNAAMMEE
  5.      ddlleerrrroorr - Gets diagnostic information
  6.  
  7. SSYYNNOOPPSSIISS
  8.      cccc [_f_l_a_g ......]] _f_i_l_e ......  --llcc [[_l_i_b_r_a_r_y ......]]
  9.  
  10.      ##iinncclluuddee <<ddllffccnn..hh>>
  11.  
  12.      cchhaarr **ddlleerrrroorr((vvooiidd));;
  13.  
  14. IIMMPPLLEEMMEENNTTAATTIIOONN
  15.      IRIX systems
  16.  
  17. DDEESSCCRRIIPPTTIIOONN
  18.      ddlleerrrroorr returns a null-terminated character string (with no trailing
  19.      newline) that describes the last error that occurred during dynamic
  20.      linking processing.  If no dynamic linking errors have occurred since
  21.      the last invocation of ddlleerrrroorr, ddlleerrrroorr returns NNUULLLL.  Thus, invoking
  22.      ddlleerrrroorr a second time, immediately following a prior invocation,
  23.      results in NNUULLLL being returned.
  24.  
  25. NNOOTTEESS
  26.      The messages returned by ddlleerrrroorr might reside in a static buffer that
  27.      is overwritten on each call to ddlleerrrroorr.  Application code should not
  28.      write to this buffer.  To preserve an error message, a program should
  29.      make its own copy of that message.
  30.  
  31.      The string to which the return value points must not be freed by the
  32.      ffrreeee(3) command.
  33.  
  34.      The ddlleerrrroorr string space is not thread-safe (whether sspprroocc(2) threads
  35.      with shared data, or POSIX-pthreads, or some other shared-data thread
  36.      code). Multiple threads doing dynamic linking calls can step on each
  37.      other's ddlleerrrroorr strings.
  38.  
  39. SSEEEE AALLSSOO
  40.      ddlleerrrroorr((33)),, ddllooppeenn((33)),, ssggiiddllaadddd((33)),, ssggiiddllooppeenn__vveerrssiioonn((33)),, ddllssyymm((33))
  41.  
  42.      This man page is available only online.
  43.